package com.example.common.vo;

import lombok.Data;

/**
 * API统一响应对象
 * 用于对外API接口的统一响应格式
 * 遵循API规范：必须包含code、message、data、requestId、version字段
 * 
 * @author AI Assistant
 * @since 1.0.0
 */
@Data
public class ApiResponse<T> {
    
    /**
     * 状态码（核心标识），建议符合HTTP状态码标准
     */
    private Integer code;
    
    /**
     * 状态描述
     */
    private String message;
    
    /**
     * 业务数据
     */
    private T data;
    
    /**
     * 请求唯一标识（排查问题用）
     */
    private String requestId;
    
    /**
     * 接口版本
     */
    private String version;
    
    public ApiResponse() {}
    
    public ApiResponse(Integer code, String message, T data, String requestId, String version) {
        this.code = code;
        this.message = message;
        this.data = data;
        this.requestId = requestId;
        this.version = version;
    }
    
    /**
     * 成功响应
     */
    public static <T> ApiResponse<T> success(T data, String requestId, String version) {
        return new ApiResponse<>(200, "success", data, requestId, version);
    }
    
    /**
     * 成功响应（无数据）
     */
    public static <T> ApiResponse<T> success(String requestId, String version) {
        return new ApiResponse<>(200, "success", null, requestId, version);
    }
    
    /**
     * 失败响应
     */
    public static <T> ApiResponse<T> error(Integer code, String message, String requestId, String version) {
        return new ApiResponse<>(code, message, null, requestId, version);
    }
    
    /**
     * 参数错误响应
     */
    public static <T> ApiResponse<T> badRequest(String message, String requestId, String version) {
        return new ApiResponse<>(400, message, null, requestId, version);
    }
    
    /**
     * 系统错误响应
     */
    public static <T> ApiResponse<T> systemError(String message, String requestId, String version) {
        return new ApiResponse<>(500, message, null, requestId, version);
    }
}
